home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / u_man / cat4 / dmedia / synthpreset.z / synthpreset
Encoding:
Text File  |  1998-10-30  |  76.4 KB  |  1,519 lines
  1.  
  2.  
  3.  
  4. ssssyyyynnnntttthhhhpppprrrreeeesssseeeetttt((((4444))))                                                  ssssyyyynnnntttthhhhpppprrrreeeesssseeeetttt((((4444))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      synthpreset - MMMMIIIIDDDDIIII synthesizer preset file
  10.  
  11. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  12.      _s_y_n_t_h_p_r_e_s_e_t files are ASCII text files containing all the information
  13.      necessary to configure a preset in the MIDI synthesizer.  This includes
  14.      all information about sound sample files, keyboard mapping, detuning,
  15.      looping, filtering, modulation, etc.
  16.  
  17. PPPPRRRREEEESSSSEEEETTTT IIIIDDDDEEEENNNNTTTTIIIIFFFFIIIIEEEERRRRSSSS
  18.      The current midi synthesizer identifies preset files via a string which
  19.      must be used as the first line of the file.  Following this is the word
  20.      PRESET in all capital letters, on its own line:
  21.  
  22.      ####SSSSyyyynnnntttthhhh PPPPrrrreeeesssseeeetttt vvvv1111....0000
  23.  
  24.      PPPPRRRREEEESSSSEEEETTTT
  25.  
  26.      Following this are lables for the various sections of the preset.  Any
  27.      line beginning with either a '#' character or a '!' character will be
  28.      treated as a comment and ignored by the parser.
  29.  
  30. HHHHEEEEAAAADDDDEEEERRRR,,,, LLLLAAAABBBBEEEELLLL,,,, AAAANNNNDDDD VVVVAAAALLLLUUUUEEEE SSSSYYYYNNNNTTTTAAAAXXXX
  31.      Synthesizer preset files are structured as a series of nested labels and
  32.      values.  The header for each section are unquoted character strings
  33.      without trailing colons.  Some sections may or must contain subsections
  34.      which begin (and usually end) with additional labels.   The preset
  35.      parameter tokens are unquoted character strings with trailing colons.
  36.      Examples of each of these can be found below.  The parameter values
  37.      themselves can take four forms:
  38.  
  39.      DDDDoooouuuubbbblllleeee----pppprrrreeeecccciiiissssiiiioooonnnn ffffllllooooaaaattttiiiinnnngggg ppppooooiiiinnnntttt vvvvaaaalllluuuueeeessss
  40.           Examples:  23.0045, -0.0001, 99.0
  41.  
  42.      IIIInnnntttteeeeggggeeeerrrr vvvvaaaalllluuuueeeessss
  43.           Examples:  0, -16, 44100
  44.  
  45.      QQQQuuuuooootttteeeedddd ssssttttrrrriiiinnnngggg vvvvaaaalllluuuueeeessss
  46.           Examples: "/disk2/sounds/violin_lowG.aifc", "None", "MultipleReset"
  47.  
  48.      BBBBoooooooolllleeeeaaaannnn vvvvaaaalllluuuueeeessss
  49.           These are a special subset of the quoted string values.  Boolean
  50.           values are only used to set a parameter to True or False, and the
  51.           appropriate quoted strings are "True" and "False".
  52.  
  53. VVVVOOOOIIIIDDDD PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  54.      In addition, a small number of parameters take no value whatsoever.
  55.      These tokens are not followed by a colon.  An example of such a parameter
  56.      is VVVVooooiiiicccceeeeEEEExxxxcccclllluuuussssiiiivvvveeeeNNNNooooEEEEvvvveeeennnnVVVVaaaalllluuuueeeessss, which indicates that the voice exclusion
  57.      range specified does not include the even-numbered keys.
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ssssyyyynnnntttthhhhpppprrrreeeesssseeeetttt((((4444))))                                                  ssssyyyynnnntttthhhhpppprrrreeeesssseeeetttt((((4444))))
  71.  
  72.  
  73.  
  74. CCCCOOOONNNNTTTTRRRROOOOLLLL SSSSOOOOUUUURRRRCCCCEEEE AAAANNNNDDDD MMMMOOOODDDDUUUULLLLAAAATTTTIIIIOOOONNNN DDDDEEEEPPPPTTTTHHHH PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  75.      One class of parameters merits special attention:  the parameters which
  76.      specify the source for some form of parameter modulation, such as
  77.      oscillator frequency modulation (vibrato).  These all the the form
  78.      XXXXModulationSource:, or in older files, XXXXControlSource:, where XXXX
  79.      represents the parameter being modulated.  The parameter value will
  80.      always be a quoted string.  The complete set of these source parameters
  81.      divides into three catagories: _s_y_n_t_h_e_s_i_s _m_o_d_u_l_e_s, _c_h_a_n_n_e_l _v_o_i_c_e
  82.      _p_a_r_a_m_e_t_e_r_s, and _M_I_D_I _c_o_n_t_r_o_l_l_e_r_s. The breakdown is as follows:
  83.  
  84.      MMMMoooodddduuuulllleeee SSSSoooouuuurrrrcccceeeessss
  85.           "None"
  86.           "Envelope1"
  87.           "Envelope2"
  88.           "Envelope3"
  89.           "Envelope4"
  90.           "Oscillator1"
  91.           "Oscillator2"
  92.           "Oscillator3"
  93.           "Oscillator4"
  94.  
  95.      CCCChhhhaaaannnnnnnneeeellll VVVVooooiiiicccceeee PPPPaaaarrrraaaammmmeeeetttteeeerrrrssss
  96.           "NoteOffVelocity"
  97.           "NoteOnVelocity"
  98.           "PolyKeyPressure"
  99.           "ChannelPressure"
  100.           "PitchBendChange"
  101.           "KeyPosition"
  102.  
  103.      MMMMIIIIDDDDIIII CCCCoooonnnnttttrrrroooolllllllleeeerrrr PPPPaaaarrrraaaammmmeeeetttteeeerrrrssss
  104.           "BankSelect"
  105.           "ModulationWheel"
  106.           "BreathController"
  107.           "FootController"
  108.           "PortamentoTime"
  109.           "DataEntry"
  110.           "ChannelVolume"
  111.           "Balance"
  112.           "Pan"
  113.           "ExpressionController"
  114.           "EffectControl1" through "EffectControl12"
  115.           "GeneralPurpose1" through "GeneralPurpose8"
  116.           "DamperPedal"
  117.           "Portamento"
  118.           "Sostenuto"
  119.           "SoftPedal"
  120.           "LegatoFootSwitch"
  121.           "Hold2"
  122.           "SoundController1" through "SoundController10"
  123.           "Effects1Depth" through "Effects5Depth"
  124.  
  125.      The depth of the modulation from any of these sources is set via a
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. ssssyyyynnnntttthhhhpppprrrreeeesssseeeetttt((((4444))))                                                  ssssyyyynnnntttthhhhpppprrrreeeesssseeeetttt((((4444))))
  137.  
  138.  
  139.  
  140.      parameter XXXXModulationDepth: (or XXXXControlDepth:), where XXXX is the
  141.      same prefix as used in the ModulationSource parameter.  The depth
  142.      parameter for each source must follow the parameter for the source itself
  143.      with no intervening parameters.  The value is always specified as a
  144.      double-precision floating point.  The initial levels of the Channel Voice
  145.      and MIDI Controller sources are floating point values scaled to the range
  146.      [0.0 - 1.0], or in the case of symmetrical parameters such as Pan, [-1.0
  147.      - 1.0].
  148.  
  149.      Each parameter which accepts some form of modulation input may have up to
  150.      five modulation sources.  The total modulation will be equal to the sum
  151.      of these five after each has been scaled by its ModulationDepth.
  152.  
  153.      Note that a few of these modulation sources are _s_t_a_t_i_c for the duration
  154.      of a voice, and the remainder are _d_y_n_a_m_i_c.  For example, "NoteOnVelocity"
  155.      is fixed at voice initialization time, as is "KeyPosition".  Some
  156.      modulation inputs only respond to _s_t_a_t_i_c sources.
  157.  
  158. PPPPRRRREEEESSSSEEEETTTT TTTTEEEERRRRMMMMIIIINNNNOOOOLLLLOOOOGGGGYYYY
  159.      Several terms will be used in the parameter descriptions below.
  160.  
  161.      SSSSpppplllliiiitttt
  162.           A single sound sample as it is used within a preset oscillator,
  163.           including its keyboard mapping range, base pitch information, and
  164.           velocity mapping information.  Most MIDI "instruments" are made up
  165.           of several splits which fill up the available keyboard space for
  166.           that instrument's total range.
  167.  
  168.      SSSSuuuussssttttaaaaiiiinnnn SSSSeeeeggggmmmmeeeennnntttt
  169.           The portion of a sound sample which is played during the time that a
  170.           key is held down on the MIDI keyboard.  This may or may not include
  171.           a LLLLoooooooopppp.
  172.  
  173.      RRRReeeelllleeeeaaaasssseeee SSSSeeeeggggmmmmeeeennnntttt
  174.           The portion of a sound sample which is played after the triggering
  175.           MIDI keyboard key has been released.  This may or may not include a
  176.           LLLLoooooooopppp.
  177.  
  178.      SSSSaaaammmmpppplllleeee LLLLoooooooopppp
  179.           The portion of the sound sample which will be repeated over and over
  180.           to allow the sound to sustain for as long as a key is held down, or
  181.           to allow the sound to fade for as long as the release time
  182.           indicates.  Currently, only two loops are supported, one for the
  183.           sustain segment and one for the release segment.  Envelopes may also
  184.           be looped.  See the EEEEnnnnvvvveeeellllooooppppeeee section for details.
  185.  
  186. PPPPRRRREEEESSSSEEEETTTT SSSSEEEECCCCTTTTIIIIOOOONNNNSSSS AAAANNNNDDDD PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  187.      The following is a list of the section headers, followed by the
  188.      parameters which may be used in each section, followed by the default
  189.      value in brackets.  Note that many of the parameters, such as GGGGaaaaiiiinnnn::::,
  190.      appear in many different sections.  Parameters in higher levels (such as
  191.      Oscillator) modify the values in the lower levels (such as Sample).  In
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202. ssssyyyynnnntttthhhhpppprrrreeeesssseeeetttt((((4444))))                                                  ssssyyyynnnntttthhhhpppprrrreeeesssseeeetttt((((4444))))
  203.  
  204.  
  205.  
  206.      this way, a parameter may be set at the higher level when there is no
  207.      need to differentiate them at a lower level.  Parameters listed after one
  208.      another without intervening text are equivalent, i.e., either form can be
  209.      used in the preset file.
  210.  
  211. IIIInnnnffffoooorrrrmmmmaaaattttiiiioooonnnn
  212.      This section contains strings such as the preset's name and author, and
  213.      in the future may include comments, creation date, etc.
  214.  
  215.      PPPPrrrreeeesssseeeettttNNNNaaaammmmeeee::::
  216.           The name of the preset, such as "Muted Trumpet". ["Default"]
  217.  
  218.      AAAAuuuutttthhhhoooorrrr::::
  219.           The name of the person, as a quoted string, who created the preset
  220.           file.  [""]
  221.  
  222. GGGGeeeennnneeeerrrraaaallll
  223.      The General section contains preset parameters such as VoiceMode and
  224.      VelocityCurve, which modify the preset as a whole.
  225.  
  226.      GGGGaaaaiiiinnnn::::
  227.           The overall volume for this preset relative to other presets.  [1.0]
  228.  
  229.      PPPPiiiittttcccchhhhBBBBeeeennnnddddRRRRaaaannnnggggeeee::::
  230.           The maximum interval, in semitones, which the pitch bend wheel can
  231.           transpose a voice when the wheel is at maximum excursion.  The
  232.           interval will be symmetrical about zero.  [2.0]
  233.  
  234.      PPPPiiiittttcccchhhhBBBBeeeennnnddddQQQQuuuuaaaannnnttttiiiizzzzeeeeVVVVaaaalllluuuueeee::::
  235.           The increment, in semitones, into which the pitch bend should be
  236.           quantized.  For example, a value of 0.1 would cause the pitch bend
  237.           to jump in 1/10 semitone increments.  [0.0]
  238.  
  239.      VVVVooooiiiicccceeeePPPPaaaannnnMMMMooooddddeeee::::
  240.           The type of panning desired for each voice.  The options are:
  241.  
  242.           """"CCCCeeeennnntttteeeerrrr""""
  243.  
  244.           No panning, no response to MIDI pan messages.
  245.  
  246.           """"CCCCoooonnnnssssttttaaaannnntttt""""
  247.  
  248.           Pan value set in preset, no response to MIDI.
  249.  
  250.           """"MMMMIIIIDDDDIIII""""
  251.  
  252.           The default.  Panning set via MIDI pan messages.
  253.  
  254.           """"CCCCoooonnnnssssttttaaaannnnttttSSSSwwwwaaaapppp""""
  255.  
  256.           Alternating channels, value set in preset.
  257.  
  258.  
  259.  
  260.  
  261.                                                                         PPPPaaaaggggeeee 4444
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268. ssssyyyynnnntttthhhhpppprrrreeeesssseeeetttt((((4444))))                                                  ssssyyyynnnntttthhhhpppprrrreeeesssseeeetttt((((4444))))
  269.  
  270.  
  271.  
  272.           """"MMMMIIIIDDDDIIIISSSSwwwwaaaapppp""""
  273.  
  274.           Alternating channels, value set via MIDI pan.
  275.  
  276.      VVVVooooiiiicccceeeePPPPaaaannnnCCCCuuuurrrrvvvveeee::::
  277.           The type of curve used to determine the relative amplitude of the
  278.           left and right channels during a pan.  The options are:
  279.  
  280.           """"LLLLiiiinnnneeeeaaaarrrrPPPPoooowwwweeeerrrr""""
  281.  
  282.           The volume for the right channel will be set to (1 - left).
  283.  
  284.           """"CCCCoooonnnnssssttttaaaannnnttttPPPPoooowwwweeeerrrr""""
  285.  
  286.           The default.  Relative levels of the two channels are determined
  287.           based on power, not amplitude.  The result is a more consistant
  288.           apparent volume as the sound moves from left to right.
  289.  
  290.      PPPPaaaannnnPPPPoooossssiiiittttiiiioooonnnnMMMMoooodddduuuullllaaaattttiiiioooonnnnSSSSoooouuuurrrrcccceeee::::
  291.  
  292.      PPPPaaaannnnPPPPoooossssiiiittttiiiioooonnnnCCCCoooonnnnttttrrrroooollllSSSSoooouuuurrrrcccceeee::::
  293.  
  294.      PPPPaaaannnnPPPPoooossssiiiittttiiiioooonnnnCCCCoooonnnnttttrrrroooollllSSSSoooouuuurrrrcccceeeeXXXX::::
  295.           Source for modulation of voice's stereo pan position (X dimension).
  296.           ["None"]
  297.  
  298.      PPPPaaaannnnPPPPoooossssiiiittttiiiioooonnnnCCCCoooonnnnttttrrrroooollllDDDDeeeepppptttthhhh::::
  299.  
  300.      PPPPaaaannnnPPPPoooossssiiiittttiiiioooonnnnCCCCoooonnnnttttrrrroooollllDDDDeeeepppptttthhhhXXXX::::
  301.  
  302.      PPPPaaaannnnPPPPoooossssiiiittttiiiioooonnnnMMMMoooodddduuuullllaaaattttiiiioooonnnnDDDDeeeepppptttthhhh::::
  303.  
  304.      PPPPaaaannnnPPPPoooossssiiiittttiiiioooonnnnMMMMoooodddduuuullllaaaattttiiiioooonnnnDDDDeeeepppptttthhhhXXXX::::
  305.           Depth of above modulation.  Maximum pan is +-1.0, so any higher
  306.           values are truncated.  [0.0]
  307.  
  308.      PPPPaaaannnnPPPPoooossssiiiittttiiiioooonnnnCCCCoooonnnnttttrrrroooollllSSSSoooouuuurrrrcccceeeeYYYY::::
  309.           Source for modulation of Y dimension (front/back) of a voice's quad
  310.           pan position.  Only used when preset's OOOOuuuuttttBBBBuuuussss is """"QQQQuuuuaaaadddd1111"""" or """"QQQQuuuuaaaadddd2222"""".
  311.           ["None"]
  312.  
  313.      PPPPaaaannnnPPPPoooossssiiiittttiiiioooonnnnMMMMoooodddduuuullllaaaattttiiiioooonnnnDDDDeeeepppptttthhhhYYYY::::
  314.           Depth of above modulation.  [0.0]
  315.  
  316.      VVVVooooiiiicccceeeeEEEExxxxcccclllluuuussssiiiivvvveeeeRRRRaaaannnnggggeeeeVVVVaaaalllluuuueeeeLLLLoooowwwweeeerrrr::::
  317.           Lower bound, specified as a MIDI key number, of the exclusive range
  318.           for this preset.  Any key played which is within the exclusive range
  319.           will terminate any other voices sounding in that range.  This is
  320.           typically used for percussion sounds such as high-hat cymbals.  If
  321.           both are zero, no exclusive range will be used.  [0]
  322.  
  323.  
  324.  
  325.  
  326.  
  327.                                                                         PPPPaaaaggggeeee 5555
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334. ssssyyyynnnntttthhhhpppprrrreeeesssseeeetttt((((4444))))                                                  ssssyyyynnnntttthhhhpppprrrreeeesssseeeetttt((((4444))))
  335.  
  336.  
  337.  
  338.      VVVVooooiiiicccceeeeEEEExxxxcccclllluuuussssiiiivvvveeeeRRRRaaaannnnggggeeeeVVVVaaaalllluuuueeeeUUUUppppppppeeeerrrr::::
  339.           Upper bound, specified as a MIDI key number, of the exclusive range
  340.           for this preset.  [0]
  341.  
  342.      VVVVooooiiiicccceeeeEEEExxxxcccclllluuuussssiiiivvvveeeeRRRRaaaannnnggggeeeeNNNNooootttteeeeLLLLoooowwwweeeerrrr::::
  343.           Lower bound, specified as a MIDI note, such as "A5" or "C#2", for
  344.           the exclusive range.  [""]
  345.  
  346.      VVVVooooiiiicccceeeeEEEExxxxcccclllluuuussssiiiivvvveeeeRRRRaaaannnnggggeeeeNNNNooootttteeeeUUUUppppppppeeeerrrr::::
  347.           Upper bound, specified as a MIDI note, such as "A5" or "C#2", for
  348.           the exclusive range.  [""]
  349.  
  350.      VVVVooooiiiicccceeeeMMMMooooddddeeee::::
  351.           The voice assignment mode.  This determines how subsequent voices
  352.           are allocated as notes are played on a MIDI channel.  The possible
  353.           values are:
  354.  
  355.           """"RRRRoooottttaaaatttteeee""""
  356.  
  357.           Voice pool is cycled; if no available voices, no voice will play.
  358.  
  359.           """"RRRRoooottttaaaatttteeeeSSSStttteeeeaaaallll""""
  360.  
  361.           The default.  Voice pool is cycled through, and if none are
  362.           available, one will be "stolen" from the active voices.
  363.  
  364.           """"RRRReeeeaaaassssssssiiiiggggnnnn""""
  365.  
  366.           Special case;  new note will only play if another voice is currently
  367.           playing the same pitch, in which case the old voice will be
  368.           "reassigned" to the new note event.
  369.  
  370.           """"RRRReeeeaaaassssssssiiiiggggnnnnSSSStttteeeeaaaallll""""
  371.  
  372.           Not currently implemented.
  373.  
  374.           """"MMMMoooonnnnooooPPPPrrrriiiioooorrrriiiittttyyyyLLLLaaaassssttttNNNNooootttteeee""""
  375.  
  376.           Mono mode, most recently played note cuts off all others.
  377.  
  378.           """"MMMMoooonnnnooooPPPPrrrriiiioooorrrriiiittttyyyyLLLLaaaassssttttNNNNooootttteeeeSSSStttteeeeaaaallll""""
  379.  
  380.           Not implemented.  Acts the same as previous.
  381.  
  382.      VVVVooooiiiicccceeeeLLLLiiiimmmmiiiitttt::::
  383.           Specifies the maximum number of simultaneous voices allowed on a
  384.           given MIDI channel for this preset.  This is extremely useful for
  385.           controlling the CPU load for MIDI presets with long sustains, like
  386.           Pianos, Harps, and Guitars.  [127]
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.                                                                         PPPPaaaaggggeeee 6666
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400. ssssyyyynnnntttthhhhpppprrrreeeesssseeeetttt((((4444))))                                                  ssssyyyynnnntttthhhhpppprrrreeeesssseeeetttt((((4444))))
  401.  
  402.  
  403.  
  404.      VVVVeeeelllloooocccciiiittttyyyyCCCCuuuurrrrvvvveeee::::
  405.           Specifies the mapping between the keyboard velocity (0 - 127) and
  406.           the resulting amplitude.  In all cases below, the variable xxxx is the
  407.           key velocity scaled to fit between 0.0 and 1.0, and '**' indicates
  408.           'to the power of'.  The Possible values are:
  409.  
  410.           """"CCCCoooonnnnssssttttaaaannnntttt""""
  411.  
  412.           Key velocity ignored, velocity set to VVVVeeeelllloooocccciiiittttyyyyCCCCoooonnnnssssttttaaaannnntttt::::.
  413.  
  414.           """"LLLLiiiinnnneeeeaaaarrrr""""
  415.  
  416.           The default.  Amplitude = x
  417.  
  418.           """"IIIInnnnvvvveeeerrrrsssseeeeLLLLiiiinnnneeeeaaaarrrr""""
  419.  
  420.           Amplitude = 1.0 - x
  421.  
  422.           """"SSSSqqqquuuuaaaarrrreeee""""
  423.  
  424.           Amplitude = x ** 2
  425.  
  426.           """"IIIInnnnvvvveeeerrrrsssseeeeSSSSqqqquuuuaaaarrrreeee""""
  427.  
  428.           Amplitude = 1.0 - ((1 - x) ** 2)
  429.  
  430.           """"CCCCuuuubbbbeeee""""
  431.  
  432.           Amplitude = x ** 3
  433.  
  434.           """"IIIInnnnvvvveeeerrrrsssseeeeCCCCuuuubbbbeeee""""
  435.  
  436.           Amplitude = 1.0 - ((1 - x) ** 3)
  437.  
  438.           """"EEEExxxxppppoooonnnneeeennnnttttiiiiaaaallll""""
  439.  
  440.           An exponential curve approximated with an averaging of the Square
  441.           and the Cube curves.
  442.  
  443.           """"IIIInnnnvvvveeeerrrrsssseeeeEEEExxxxppppoooonnnneeeennnnttttiiiiaaaallll""""
  444.  
  445.           Exponential curve with opposite concavity;  i.e., bulges up rather
  446.           than down.
  447.  
  448.           """"LLLLooooggggaaaarrrriiiitttthhhhmmmmiiiicccc""""
  449.  
  450.           Logarithmic curve with a complex formula.  Curve rises more steeply
  451.           at first, then levels off gradually.
  452.  
  453.           """"IIIInnnnvvvveeeerrrrsssseeeeLLLLooooggggaaaarrrriiiitttthhhhmmmmiiiicccc""""
  454.  
  455.           Logarithmic curve with opposite concavity;  i.e., bulges down rather
  456.  
  457.  
  458.  
  459.                                                                         PPPPaaaaggggeeee 7777
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466. ssssyyyynnnntttthhhhpppprrrreeeesssseeeetttt((((4444))))                                                  ssssyyyynnnntttthhhhpppprrrreeeesssseeeetttt((((4444))))
  467.  
  468.  
  469.  
  470.           than up.
  471.  
  472.           In terms of expressivity, the Constant setting is the least,
  473.           followed by Logarithmic, Linear, Square, Exponential, and Cube.  The
  474.           Inverse settings follow approximately the same sequence.
  475.  
  476.      VVVVeeeelllloooocccciiiittttyyyyCCCCoooonnnnssssttttaaaannnntttt::::
  477.           If VelocityCurve: is set to "Constant", the value will be the
  478.           constant. [127]
  479.  
  480.      KKKKeeeeyyyybbbbooooaaaarrrrddddTTTTrrrraaaacccckkkkiiiinnnnggggCCCCoooonnnnssssttttaaaannnntttt::::
  481.           This value determines the pitch interval between successive keys on
  482.           the keyboard.  A value of 1.0 is default, indicating 1.0 semitone
  483.           per key.  A value of 2.0 would cause the pitch to go up by 2.0
  484.           semitones per key.  A value of 0.1 would cause each successive key
  485.           to raise the pitch by 1/10th of a semitone, resulting in a 120-
  486.           note-per-octave scale.  NNNNOOOOTTTTEEEE::::  The tracking occurs on a per split
  487.           basis.  Each sample root pitch forms the starting point for a scale.
  488.           To achieve a complete keyboard scale in an alternate tuning, the
  489.           sample root pitches would need to be adjusted accordingly.  [1.0]
  490.  
  491.      TTTTrrrraaaannnnssssppppoooosssseeee::::
  492.           An integer value indicating the number of semitones to transpose the
  493.           oscillator pitch up or down.  TTTTrrrraaaannnnssssppppoooosssseeee behaves differently from
  494.           TTTTuuuunnnneeee in that it will interact with the sample keynote mapping
  495.           whereas the TTTTuuuunnnneeee parameter does not.  [0]
  496.  
  497.      SSSSaaaammmmpppplllleeeeSSSSeeeeaaaarrrrcccchhhhPPPPaaaatttthhhh::::
  498.           A colon-separated list of directories which should be searched for
  499.           samples prior to searching the system default directories.  For
  500.           example, "/disk/sounds:/tmp/soundfiles".  A single directory should
  501.           not have a trailing colon.  [NULL]
  502.  
  503.      OOOOuuuuttttBBBBuuuussss::::
  504.           The output assignment for this preset's voices.  Midisynth has eight
  505.           output busses, which are assigned sequentially to each available
  506.           audio port output channel.  If mmmmiiiiddddiiiissssyyyynnnntttthhhh is started in 2-channel
  507.           mode (the default), only the first two busses are useful;  starting
  508.           it in 8-channel mode will allow all eight busses to be used.  The
  509.           currently supported parameters are:
  510.  
  511.           """"SSSStttteeeerrrreeeeoooo1111""""
  512.  
  513.           Voices panned across busses (and channels) 1 and 2.  The default.
  514.  
  515.           """"SSSStttteeeerrrreeeeoooo2222""""
  516.  
  517.           Voices panned across busses (and channels) 3 and 4.  Only useful in
  518.           4- or 8-channel mode.
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.                                                                         PPPPaaaaggggeeee 8888
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532. ssssyyyynnnntttthhhhpppprrrreeeesssseeeetttt((((4444))))                                                  ssssyyyynnnntttthhhhpppprrrreeeesssseeeetttt((((4444))))
  533.  
  534.  
  535.  
  536.           """"SSSStttteeeerrrreeeeoooo3333""""
  537.  
  538.           Voices panned across busses (and channels) 5 and 6.  Only useful in
  539.           8-channel mode.
  540.  
  541.           """"SSSStttteeeerrrreeeeoooo4444""""
  542.  
  543.           Voices panned across busses (and channels) 7 and 8.  Only useful in
  544.           8-channel mode.
  545.  
  546.           """"QQQQuuuuaaaadddd1111""""
  547.  
  548.           Voices panned across busses 1 through 4.  Panning defined as X/Y
  549.           values using PPPPaaaannnnPPPPoooossssiiiittttiiiioooonnnnXXXX and PPPPaaaannnnPPPPoooossssiiiittttiiiioooonnnnYYYY for static values, and
  550.           PPPPaaaannnnPPPPoooossssiiiittttiiiioooonnnnCCCCoooonnnnttttrrrroooollllSSSSoooouuuurrrrcccceeeeXXXX, PPPPaaaannnnPPPPoooossssiiiittttiiiioooonnnnCCCCoooonnnnttttrrrroooollllSSSSoooouuuurrrrcccceeeeYYYY, etc., for
  551.           controllable parameters.  Only useful in 4- or 8-channel mode.
  552.  
  553.           """"QQQQuuuuaaaadddd2222""""
  554.  
  555.           Voices panned across busses 5 through 8.  Same rules for panning as
  556.           above.  Only useful in 8-channel mode.
  557.  
  558. OOOOsssscccciiiillllllllaaaattttoooorrrrNNNN
  559.      Parameters for the Nth voice oscillator.  Numbering starts with 1, up to
  560.      a maximum of 4.  Parameters:
  561.  
  562.      GGGGaaaaiiiinnnn::::
  563.           A fixed gain offset for the oscillator signal.  This is generally
  564.           used only for oscillators which function as control sources;  audio
  565.           oscillator gains are adjusted via the GGGGaaaaiiiinnnnCCCCoooonnnnttttrrrroooollllDDDDeeeepppptttthhhh parameter,
  566.           below.  [0.0]
  567.  
  568.      GGGGaaaatttteeeeEEEElllleeeemmmmeeeennnntttt::::
  569.           If this parameter is true, this oscillator will be examined to
  570.           determine if a given voice should continue to sound, or if the voice
  571.           should be considered "finished" and shut off.  If false, the state
  572.           of this oscillator will be ignored.  ["True"]
  573.  
  574.      MMMMeeeetttthhhhoooodddd::::
  575.  
  576.      IIIInnnntttteeeerrrrppppoooollllaaaattttiiiioooonnnn::::
  577.           Specifies the interpolation method to be used to transpose the sound
  578.           samples up and down on the keyboard.  Possible values are:
  579.  
  580.           """"FFFFiiiixxxxeeeedddd""""
  581.  
  582.           No transposition.  Oscillator sounds at root pitch only.
  583.  
  584.           """"AAAAddddddddDDDDrrrroooopppp""""
  585.  
  586.           The default.  Truncated table indexing.  This is very useful for
  587.           controlling oscillators and sometimes for audio oscillators which
  588.  
  589.  
  590.  
  591.                                                                         PPPPaaaaggggeeee 9999
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598. ssssyyyynnnntttthhhhpppprrrreeeesssseeeetttt((((4444))))                                                  ssssyyyynnnntttthhhhpppprrrreeeesssseeeetttt((((4444))))
  599.  
  600.  
  601.  
  602.           are playing simple waveforms such as sine waves, but the output
  603.           waveform is usually too distorted for audio oscillator use.
  604.  
  605.           """"LLLLiiiinnnneeeeaaaarrrr""""
  606.  
  607.           Linear interpolative table indexing.  This produces the best quality
  608.           waveform for audio oscillators.  It should not be used for control
  609.           oscillators because it takes a larger amount of CPU cycles to
  610.           compute.
  611.  
  612.      TTTTuuuunnnneeeeKKKKeeeeyyyybbbbooooaaaarrrrddddTTTTrrrraaaacccckkkkiiiinnnngggg::::
  613.           Indicates whether this oscillator will track the keyboard, i.e.,
  614.           whether its pitch will transpose up and down as different keys are
  615.           pressed.  This is the default for audio oscillators, but is often
  616.           not used for control oscillators.  ["True"]
  617.  
  618.      CCCCoooonnnnttttrrrroooollllEEEElllleeeemmmmeeeennnntttt::::
  619.           If "True", indicates that this oscillator is to be used an a control
  620.           module, i.e., its output will modulate some other module's
  621.           parameters.  If "False", then this oscillator will be an audio
  622.           oscillator, and its output will be summed in the signal mixer and
  623.           added to the voice output.  ["False"]
  624.  
  625.      GGGGaaaaiiiinnnnCCCCoooonnnnttttrrrroooollllSSSSoooouuuurrrrcccceeee::::
  626.  
  627.      GGGGaaaaiiiinnnnMMMMoooodddduuuullllaaaattttiiiioooonnnnSSSSoooouuuurrrrcccceeee::::
  628.           Source for modulation of the oscillators's volume.  See the section
  629.           on CCCCOOOONNNNTTTTRRRROOOOLLLL SSSSOOOOUUUURRRRCCCCEEEE AAAANNNNDDDD MMMMOOOODDDDUUUULLLLAAAATTTTIIIIOOOONNNN DDDDEEEEPPPPTTTTHHHH PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS for details.
  630.           ["NoteOnVelocity"]
  631.  
  632.      GGGGaaaaiiiinnnnCCCCoooonnnnttttrrrroooollllDDDDeeeepppptttthhhh::::
  633.  
  634.      GGGGaaaaiiiinnnnMMMMoooodddduuuullllaaaattttiiiioooonnnnDDDDeeeepppptttthhhh::::
  635.           The depth of the previous modulation source.  For most modulating
  636.           sources, the resulting gain will be between 0.0 and
  637.           GainModulationDepth.  [1.0]
  638.  
  639.      TTTTuuuunnnneeeeCCCCoooonnnnttttrrrroooollllSSSSoooouuuurrrrcccceeee::::
  640.  
  641.      TTTTuuuunnnneeeeMMMMoooodddduuuullllaaaattttiiiioooonnnnSSSSoooouuuurrrrcccceeee::::
  642.           Source for modulation of the oscillators pitch (tuning).  See the
  643.           section on CCCCOOOONNNNTTTTRRRROOOOLLLL SSSSOOOOUUUURRRRCCCCEEEE AAAANNNNDDDD MMMMOOOODDDDUUUULLLLAAAATTTTIIIIOOOONNNN DDDDEEEEPPPPTTTTHHHH PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS for
  644.           details.  ["None"]
  645.  
  646.      TTTTuuuunnnneeeeCCCCoooonnnnttttrrrroooollllDDDDeeeepppptttthhhh::::
  647.  
  648.      TTTTuuuunnnneeeeMMMMoooodddduuuullllaaaattttiiiioooonnnnDDDDeeeepppptttthhhh::::
  649.           The depth of the pitch modulation, in semitones.  For symmetrical
  650.           modulating waveforms, the pitch will rise this number of semitones
  651.           above the base pitch, then fall to this number of semitones below
  652.           the base pitch.  [0.0]
  653.  
  654.  
  655.  
  656.  
  657.                                                                        PPPPaaaaggggeeee 11110000
  658.  
  659.  
  660.  
  661.  
  662.  
  663.  
  664. ssssyyyynnnntttthhhhpppprrrreeeesssseeeetttt((((4444))))                                                  ssssyyyynnnntttthhhhpppprrrreeeesssseeeetttt((((4444))))
  665.  
  666.  
  667.  
  668. OOOOsssscccciiiillllllllaaaattttoooorrrr SSSSuuuubbbbsssseeeeccccttttiiiioooonnnnssss
  669.      There are two possible subsections for Oscillator.
  670.  
  671.  
  672. SSSSiiiibbbblllliiiinnnngggg
  673.      An optional subsection of Oscillator;  contains parameters for up to 4
  674.      sibling oscillator outputs.  These are duplicates of the oscillator
  675.      waveform with optional detuning and (in the future) gain adjustments.
  676.      The final sibling entry must be followed by the subsection termination
  677.      lable EEEEnnnnddddSSSSiiiibbbblllliiiinnnnggggssss.
  678.  
  679.      TTTTuuuunnnneeee::::               Tuning factor, in semitones, for this sibling.  [0.0]
  680.  
  681.      PPPPhhhhaaaasssseeee::::              Not yet implemented.
  682.  
  683.      SSSSaaaammmmpppplllleeeeSSSSeeeelllleeeeccccttttMMMMooooddddeeee::::   Not yet implemented.
  684.  
  685.  
  686. SSSSaaaammmmpppplllleeee
  687.      A required subsection of Oscillator;  contains parameters for each sound
  688.      sample which is to be used as part of this voice as expressed through
  689.      this oscillator.  Any number of SSSSaaaammmmpppplllleeee listings may be used, but they
  690.      must all be listed together and the final entry should be followed by the
  691.      subsection termination label EEEEnnnnddddSSSSaaaammmmpppplllleeeessss.
  692.  
  693.      MMMMeeeemmmmoooorrrryyyyRRRReeeessssiiiiddddeeeennnntttt::::
  694.           Not yet implemented.
  695.  
  696.      CCCChhhhaaaannnnnnnneeeellllMMMMooooddddeeee::::
  697.           Not yet implemented.
  698.  
  699.      DDDDiiiirrrreeeeccccttttiiiioooonnnn::::
  700.           Indicates the direction the sample will be played.  Possible values
  701.           are:
  702.  
  703.           """"FFFFoooorrrrwwwwaaaarrrrdddd""""
  704.  
  705.           Default.  Sample will be played from beginning to end.
  706.  
  707.           """"BBBBaaaacccckkkkwwwwaaaarrrrdddd""""
  708.  
  709.           Sample will be played from end to beginning (reversed).
  710.  
  711.           """"FFFFoooorrrrwwwwaaaarrrrddddAAAAnnnnddddBBBBaaaacccckkkkwwwwaaaarrrrdddd""""
  712.  
  713.           Not yet implemented.
  714.  
  715.      SSSSuuuussssttttaaaaiiiinnnnSSSSttttaaaarrrrttttTTTTiiiimmmmeeee::::
  716.           Offset in seconds to the beginning of the sample's sustain segment.
  717.           [0.0]
  718.  
  719.  
  720.  
  721.  
  722.  
  723.                                                                        PPPPaaaaggggeeee 11111111
  724.  
  725.  
  726.  
  727.  
  728.  
  729.  
  730. ssssyyyynnnntttthhhhpppprrrreeeesssseeeetttt((((4444))))                                                  ssssyyyynnnntttthhhhpppprrrreeeesssseeeetttt((((4444))))
  731.  
  732.  
  733.  
  734.      SSSSuuuussssttttaaaaiiiinnnnEEEEnnnnddddTTTTiiiimmmmeeee::::
  735.           Offset in seconds to the end of the sample's sustain segment.
  736.           [Sample duration].
  737.  
  738.      RRRReeeelllleeeeaaaasssseeeeSSSSttttaaaarrrrttttTTTTiiiimmmmeeee::::
  739.           Offset in seconds to the beginning of the sample's release segment.
  740.           [0.0]
  741.  
  742.      RRRReeeelllleeeeaaaasssseeeeEEEEnnnnddddTTTTiiiimmmmeeee::::
  743.           Offset in seconds to the end of the sample's release segment.
  744.           [Sample duration]
  745.  
  746.      SSSSuuuussssttttaaaaiiiinnnnLLLLooooooooppppSSSSttttaaaarrrrttttTTTTiiiimmmmeeee::::
  747.           Offset in seconds to the beginning of the sample's sustain loop.
  748.           [0.0]
  749.  
  750.      SSSSuuuussssttttaaaaiiiinnnnLLLLooooooooppppEEEEnnnnddddTTTTiiiimmmmeeee::::
  751.           Offset in seconds to the end of the sustain portion of the sample.
  752.           [SustainEndTime].
  753.  
  754.      RRRReeeelllleeeeaaaasssseeeeLLLLooooooooppppSSSSttttaaaarrrrttttTTTTiiiimmmmeeee::::
  755.           Offset in seconds to the beginning of the sample's release loop.
  756.           [0.0]
  757.  
  758.      RRRReeeelllleeeeaaaasssseeeeLLLLooooooooppppEEEEnnnnddddTTTTiiiimmmmeeee::::
  759.           Offset in seconds to the end of the sample's release loop.  [Sample
  760.           duration]
  761.  
  762.      LLLLooooooooppppTTTTuuuunnnneeee::::
  763.           Amount in semitones to adjust the sample loops' pitch versus the
  764.           unlooped portion.  If the sample contains more than one loop, all
  765.           will be adjusted. [0.0]
  766.  
  767.      LLLLooooooooppppGGGGaaaaiiiinnnn::::
  768.           Not yet implemented.
  769.  
  770.      LLLLooooooooppppGGGGaaaaiiiinnnnddddBBBB::::
  771.           Not yet implemented.
  772.  
  773.      SSSSuuuussssttttaaaaiiiinnnnGGGGaaaaiiiinnnn::::
  774.           Factor to multiply the sample's sustain segment by.  [1.0]
  775.  
  776.      SSSSuuuussssttttaaaaiiiinnnnGGGGaaaaiiiinnnnddddBBBB::::
  777.           Amount in decibels to adjust the sample's sustain segment.  [0.0]
  778.  
  779.      SSSSuuuussssttttaaaaiiiinnnnTTTTuuuunnnneeee::::
  780.           Amount in semitones to adjust the sample's sustain segment versus
  781.           the release segment.  [0.0]
  782.  
  783.      SSSSuuuussssttttaaaaiiiinnnnDDDDiiiirrrreeeeccccttttiiiioooonnnn::::
  784.           The direction for the sample's sustain segment.  See DDDDiiiirrrreeeeccccttttiiiioooonnnn::::,
  785.           above.  ["Forward"]
  786.  
  787.  
  788.  
  789.                                                                        PPPPaaaaggggeeee 11112222
  790.  
  791.  
  792.  
  793.  
  794.  
  795.  
  796. ssssyyyynnnntttthhhhpppprrrreeeesssseeeetttt((((4444))))                                                  ssssyyyynnnntttthhhhpppprrrreeeesssseeeetttt((((4444))))
  797.  
  798.  
  799.  
  800.      RRRReeeelllleeeeaaaasssseeeeGGGGaaaaiiiinnnn::::
  801.           Factor to multiply the sample's release segment by.  [1.0]
  802.  
  803.      RRRReeeelllleeeeaaaasssseeeeGGGGaaaaiiiinnnnddddBBBB::::
  804.           Amount in decibels to adjust the sample's release segment.  [0.0]
  805.  
  806.      RRRReeeelllleeeeaaaasssseeeeTTTTuuuunnnneeee::::
  807.           Amount in semitones to adjust the sample's release segment versus
  808.           the sustain segment.  [0.0]
  809.  
  810.      RRRReeeelllleeeeaaaasssseeeeDDDDiiiirrrreeeeccccttttiiiioooonnnn::::
  811.           The direction for the sample's release segment.  See DDDDiiiirrrreeeeccccttttiiiioooonnnn::::,
  812.           above.  ["Forward"]
  813.  
  814.      SSSSuuuussssttttaaaaiiiinnnnLLLLooooooooppppTTTTuuuunnnneeee::::
  815.           Amount in semitones to adjust the sample's sustain loop pitch versus
  816.           the unlooped portion(s).  [0.0]
  817.  
  818.      SSSSuuuussssttttaaaaiiiinnnnLLLLooooooooppppGGGGaaaaiiiinnnn::::
  819.           Not yet implemented.
  820.  
  821.      SSSSuuuussssttttaaaaiiiinnnnLLLLooooooooppppGGGGaaaaiiiinnnnddddBBBB::::
  822.           Not yet implemented.
  823.  
  824.      RRRReeeelllleeeeaaaasssseeeeLLLLooooooooppppTTTTuuuunnnneeee::::
  825.           Amount in semitones to adjust the sample's release loop pitch versus
  826.           the unlooped portion(s).  [0.0]
  827.  
  828.      RRRReeeelllleeeeaaaasssseeeeLLLLooooooooppppGGGGaaaaiiiinnnn::::
  829.           Not yet implemented.
  830.  
  831.      RRRReeeelllleeeeaaaasssseeeeLLLLooooooooppppGGGGaaaaiiiinnnnddddBBBB::::
  832.           Not yet implemented.
  833.  
  834.      NNNNooootttteeeeMMMMaaaappppVVVVaaaalllluuuueeeeBBBBaaaasssseeee::::
  835.           Specifies the base (original untransposed) pitch of a sound sample,
  836.           in MIDI key number units.  [60]
  837.  
  838.      NNNNooootttteeeeMMMMaaaappppVVVVaaaalllluuuueeeeLLLLoooowwwweeeerrrr::::
  839.           Specifies the lower limit of the keyboard range in which this sample
  840.           will sound, as a MIDI key number.  [1]
  841.  
  842.      NNNNooootttteeeeMMMMaaaappppVVVVaaaalllluuuueeeeUUUUppppppppeeeerrrr::::
  843.           Specifies the upper limit of the keyboard range in which this sample
  844.           will sound, as a MIDI key number.  [127]
  845.  
  846.      NNNNooootttteeeeMMMMaaaappppNNNNooootttteeeeBBBBaaaasssseeee::::
  847.  
  848.      NNNNooootttteeeeMMMMaaaappppNNNNoooottttaaaattttiiiioooonnnnBBBBaaaasssseeee::::
  849.           Specifies the base (original untransposed) pitch of a sound sample,
  850.           as a note name.  ["C5"]
  851.  
  852.  
  853.  
  854.  
  855.                                                                        PPPPaaaaggggeeee 11113333
  856.  
  857.  
  858.  
  859.  
  860.  
  861.  
  862. ssssyyyynnnntttthhhhpppprrrreeeesssseeeetttt((((4444))))                                                  ssssyyyynnnntttthhhhpppprrrreeeesssseeeetttt((((4444))))
  863.  
  864.  
  865.  
  866.      NNNNooootttteeeeMMMMaaaappppNNNNooootttteeeeLLLLoooowwwweeeerrrr::::
  867.  
  868.      NNNNooootttteeeeMMMMaaaappppNNNNoooottttaaaattttiiiioooonnnnLLLLoooowwwweeeerrrr::::
  869.           Specifies the lower limit of the keyboard range in which this sample
  870.           will sound, as a note name ["C-1"]
  871.  
  872.      NNNNooootttteeeeMMMMaaaappppNNNNooootttteeeeUUUUppppppppeeeerrrr::::
  873.  
  874.      NNNNooootttteeeeMMMMaaaappppNNNNoooottttaaaattttiiiioooonnnnUUUUppppppppeeeerrrr::::
  875.           Specifies the upper limit of the keyboard range in which this sample
  876.           will sound, as a note name.  ["G9"]
  877.  
  878.      VVVVeeeelllloooocccciiiittttyyyyMMMMaaaappppLLLLoooowwwweeeerrrr::::
  879.           Specifies the lower limit of the keyboard velocity range for which
  880.           this sample will sound.  [1]
  881.  
  882.      VVVVeeeelllloooocccciiiittttyyyyMMMMaaaappppUUUUppppppppeeeerrrr::::
  883.           Specifies the upper limit of the keyboard velocity range for which
  884.           this sample will sound.  [127]
  885.  
  886. FFFFiiiilllltttteeeerrrrNNNN
  887.      Parameters for the Nth voice filter.  Numbering starts with 1 up to a
  888.      maximum of 4.
  889.  
  890.      FFFFrrrreeeeqqqquuuueeeennnnccccyyyy::::
  891.           The filter cutoff frequency.  This should be specified as a double-
  892.           precision floating point between 0.0 and 1.0, where 0.0 is
  893.           effectively a cutoff of 0.0 Hz., and 1.0 is the maximum cutoff
  894.           frequency (set to 1/2 of the current audio sampling rate).  [1.0]
  895.  
  896.      RRRReeeessssoooonnnnaaaannnncccceeee::::
  897.           The amount of resonance at the cutoff frequency, scaled between 0.0
  898.           (no resonance) and 1.0 (maximum resonance).  Musically useful values
  899.           are between 0.0 and 0.5.  Resonance has no affect on first-order
  900.           low- and high-pass filters.  [0.0]
  901.  
  902.      GGGGaaaaiiiinnnnddddBBBB::::
  903.           A gain value, used to compensate for filter settings (such as very
  904.           high resonance) which either amplify or attenuate the signal enough
  905.           to affect the overall balance.  Only implemented for second and
  906.           higher order LowPass filters.  [0.0]
  907.  
  908.      MMMMooooddddeeee::::
  909.           Selects the type of filter to be used.  Possible values are:
  910.  
  911.           """"LLLLoooowwwwPPPPaaaassssssss""""
  912.  
  913.           Low pass filter.
  914.  
  915.           """"HHHHiiiigggghhhhPPPPaaaassssssss""""
  916.  
  917.           High pass filter.
  918.  
  919.  
  920.  
  921.                                                                        PPPPaaaaggggeeee 11114444
  922.  
  923.  
  924.  
  925.  
  926.  
  927.  
  928. ssssyyyynnnntttthhhhpppprrrreeeesssseeeetttt((((4444))))                                                  ssssyyyynnnntttthhhhpppprrrreeeesssseeeetttt((((4444))))
  929.  
  930.  
  931.  
  932.           """"BBBBaaaannnnddddPPPPaaaassssssss""""
  933.  
  934.           Band pass filter.
  935.  
  936.           """"BBBBaaaannnnddddSSSSttttoooopppp""""
  937.  
  938.           Band stop or notch filter.
  939.  
  940.      OOOOrrrrddddeeeerrrr::::
  941.           Specifies the filter order (number of sections).  The more sections,
  942.           the steeper the slope of the cutoff point, and the greater the
  943.           attenuation (suppression) of frequencies past the cutoff frequency.
  944.           Possible values are """"1111sssstttt"""", """"2222nnnndddd"""", """"4444tttthhhh"""", and """"8888tttthhhh"""", indicating 1, 2,
  945.           4, and 8 sections, respectively.  More sections require more CPU
  946.           cycles.
  947.  
  948.      SSSSaaaattttuuuurrrraaaattttiiiioooonnnnRRRRaaaaiiiillll::::
  949.  
  950.      SSSSaaaattttuuuurrrraaaattttiiiioooonnnnRRRRaaaaiiiillllLLLLoooowwwweeeerrrr::::
  951.  
  952.      SSSSaaaattttuuuurrrraaaattttiiiioooonnnnRRRRaaaaiiiillllUUUUppppppppeeeerrrr::::
  953.           These three are not yet implemented.
  954.  
  955.      FFFFrrrreeeeqqqquuuueeeennnnccccyyyyCCCCoooonnnnttttrrrroooollllSSSSoooouuuurrrrcccceeee::::
  956.  
  957.      FFFFrrrreeeeqqqquuuueeeennnnccccyyyyMMMMoooodddduuuullllaaaattttiiiioooonnnnSSSSoooouuuurrrrcccceeee::::
  958.           Source for modulation of the filter's cutoff frequency.  See the
  959.           section on CCCCOOOONNNNTTTTRRRROOOOLLLL SSSSOOOOUUUURRRRCCCCEEEE AAAANNNNDDDD MMMMOOOODDDDUUUULLLLAAAATTTTIIIIOOOONNNN DDDDEEEEPPPPTTTTHHHH PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS for
  960.           details.  ["None"]
  961.  
  962.      FFFFrrrreeeeqqqquuuueeeennnnccccyyyyCCCCoooonnnnttttrrrroooollllDDDDeeeepppptttthhhh::::
  963.  
  964.      FFFFrrrreeeeqqqquuuueeeennnnccccyyyyMMMMoooodddduuuullllaaaattttiiiioooonnnnDDDDeeeepppptttthhhh::::
  965.           Depth of the previous frequency modulation, as a fraction of the
  966.           total frequency range (0.0 - 1.0).
  967.  
  968.      RRRReeeessssoooonnnnaaaannnncccceeeeCCCCoooonnnnttttrrrroooollllSSSSoooouuuurrrrcccceeee::::
  969.  
  970.      RRRReeeessssoooonnnnaaaannnncccceeeeMMMMoooodddduuuullllaaaattttiiiioooonnnnSSSSoooouuuurrrrcccceeee::::
  971.           Source for modulation of the filter's resonance.  See the section on
  972.           CCCCOOOONNNNTTTTRRRROOOOLLLL SSSSOOOOUUUURRRRCCCCEEEE AAAANNNNDDDD MMMMOOOODDDDUUUULLLLAAAATTTTIIIIOOOONNNN DDDDEEEEPPPPTTTTHHHH PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS for details.
  973.           ["None"]
  974.  
  975.      RRRReeeessssoooonnnnaaaannnncccceeeeCCCCoooonnnnttttrrrroooollllDDDDeeeepppptttthhhh::::
  976.  
  977.      RRRReeeessssoooonnnnaaaannnncccceeeeMMMMoooodddduuuullllaaaattttiiiioooonnnnDDDDeeeepppptttthhhh::::
  978.           Depth of the resonance modulation, as a fraction of the total
  979.           resonance range (0.0 - 1.0).
  980.  
  981.  
  982.  
  983.  
  984.  
  985.  
  986.  
  987.                                                                        PPPPaaaaggggeeee 11115555
  988.  
  989.  
  990.  
  991.  
  992.  
  993.  
  994. ssssyyyynnnntttthhhhpppprrrreeeesssseeeetttt((((4444))))                                                  ssssyyyynnnntttthhhhpppprrrreeeesssseeeetttt((((4444))))
  995.  
  996.  
  997.  
  998. EnvelopeN
  999.      Parameters for the Nth envelope generator.  Numbering starts with 1, up
  1000.      to a maximum of 4.  Envelopes may have up to 8 segments (8 levels
  1001.      separated by 7 times).  Envelopes may also be looped;  the segments
  1002.      within the specified loop will cycle continuously during the sustain
  1003.      and/or release portions of the envelope.  The complete set of possible
  1004.      envelope parameters:
  1005.  
  1006.      LLLLeeeevvvveeeellllCCCCoooouuuunnnntttt::::
  1007.           The total number of envelope levels.  Value must be between 1 and 8,
  1008.           inclusive.  [4]
  1009.  
  1010.      TTTTiiiimmmmeeee::::
  1011.           Specify the time required to reach a level, starting with Time1
  1012.           (time to move from Level0 to Level1).  Each subsequent TTTTiiiimmmmeeee:::: entry
  1013.           will address a subsequent time, up to Time7.  [Time0: 0.0; All
  1014.           others: 1.0]
  1015.  
  1016.      TTTTiiiimmmmeeeeNNNN::::
  1017.           Specify the time to go from level (N-1) to level N.  N must be
  1018.           between 1 and 7, and the entries _m_u_s_t be in ascending order. The
  1019.           level count of the envelope will be set to N + 1 for the maximum
  1020.           (final) value of N found.  [Time0: 0.0; All others: 1.0]
  1021.  
  1022.      DDDDeeeellllaaaayyyyTTTTiiiimmmmeeee::::
  1023.           An alternate way to specify the time it takes to go from level0 to
  1024.           level1. If both of these levels are set to zero, this will function
  1025.           as an envelope delay.  This label cannot be used with AttackTime in
  1026.           the same envelope section.  [0.0]
  1027.  
  1028.      AAAAttttttttaaaacccckkkkTTTTiiiimmmmeeee::::
  1029.           An alternate way to specify the time it takes to go from level0 to
  1030.           level1.  This label cannot be used with DelayTime in the same
  1031.           envelope section.  [0.0]
  1032.  
  1033.      DDDDeeeeccccaaaayyyyTTTTiiiimmmmeeee::::
  1034.           An alternate way to specify the time it takes to go from level1 (the
  1035.           attack peak value) to level2 (the sustain level).  [1.0]
  1036.  
  1037.      RRRReeeelllleeeeaaaasssseeeeTTTTiiiimmmmeeee::::
  1038.           An alternate way to specify the time it takes to go from level2 (the
  1039.           sustain level) to level3 (the release level).  [1.0]
  1040.  
  1041.      TTTTiiiimmmmeeeeAAAAttttttttaaaacccckkkk1111::::
  1042.  
  1043.      TTTTiiiimmmmeeeeAAAAttttttttaaaacccckkkk2222::::
  1044.  
  1045.      TTTTiiiimmmmeeeeDDDDeeeeccccaaaayyyy1111::::
  1046.  
  1047.      TTTTiiiimmmmeeeeDDDDeeeeccccaaaayyyy2222::::
  1048.  
  1049.  
  1050.  
  1051.  
  1052.  
  1053.                                                                        PPPPaaaaggggeeee 11116666
  1054.  
  1055.  
  1056.  
  1057.  
  1058.  
  1059.  
  1060. ssssyyyynnnntttthhhhpppprrrreeeesssseeeetttt((((4444))))                                                  ssssyyyynnnntttthhhhpppprrrreeeesssseeeetttt((((4444))))
  1061.  
  1062.  
  1063.  
  1064.      TTTTiiiimmmmeeeeRRRReeeelllleeeeaaaasssseeee1111::::
  1065.  
  1066.      TTTTiiiimmmmeeeeRRRReeeelllleeeeaaaasssseeee2222::::
  1067.           These six labels allow for easy specification of the segment times
  1068.           for a six-level envelope like those found in many commercial
  1069.           synthesizers.  For any given envelope section, they should be used
  1070.           together as a set and not mixed with the other label types.
  1071.  
  1072.      LLLLeeeevvvveeeellll::::
  1073.           Specify the envelope value for a level, starting with level 0.  Each
  1074.           subsequent Level:  entry will address a subsequent level, up to
  1075.           level7 (eight levels in all).  [Level0 and Level1: 1.0;  All others:
  1076.           0.0]
  1077.  
  1078.      LLLLeeeevvvveeeellllNNNN::::
  1079.           Specify the envelope value for level N.  Numbering starts with 0
  1080.           (the resting state of the envelope) and has a maximum of 7.  The
  1081.           final level always represents the post-release level.  [Level0 and
  1082.           Level1: 1.0;  All others:  0.0]
  1083.  
  1084.      SSSSttttaaaarrrrttttLLLLeeeevvvveeeellll::::
  1085.           Alternate for LLLLeeeevvvveeeellll0000::::.  [1.0]
  1086.  
  1087.      AAAAttttttttaaaacccckkkkLLLLeeeevvvveeeellll::::
  1088.           Alternate for LLLLeeeevvvveeeellll1111::::.  [1.0]
  1089.  
  1090.      SSSSuuuussssttttaaaaiiiinnnnLLLLeeeevvvveeeellll::::
  1091.           Alternate for LLLLeeeevvvveeeellll2222::::.  [1.0]
  1092.  
  1093.      RRRReeeelllleeeeaaaasssseeeeLLLLeeeevvvveeeellll::::
  1094.           Alternate for LLLLeeeevvvveeeellll3333::::.  [0.0]
  1095.  
  1096.      LLLLeeeevvvveeeellllAAAAttttttttaaaacccckkkk1111::::
  1097.  
  1098.      LLLLeeeevvvveeeellllAAAAttttttttaaaacccckkkk2222::::
  1099.  
  1100.      LLLLeeeevvvveeeellllDDDDeeeeccccaaaayyyy1111::::
  1101.  
  1102.      LLLLeeeevvvveeeellllDDDDeeeeccccaaaayyyy2222::::
  1103.  
  1104.      LLLLeeeevvvveeeellllRRRReeeelllleeeeaaaasssseeee1111::::
  1105.           These five labels allow for easy specification of the levels for a
  1106.           six-segment envelope like those found in many commercial
  1107.           synthesizers.  For any given envelope section, they should be used
  1108.           together as a set (with the six time labels described above) and not
  1109.           mixed with the other label types.  NNNNooootttteeee::::  Midisynth makes no
  1110.           assumptions about the initial and final levels for its envelopes, as
  1111.           opposed to many synthesizers which require them to be zero levels.
  1112.           When using the above level specifiers, they must be preceeded by a
  1113.           SSSSttttaaaarrrrttttLLLLeeeevvvveeeellll:::: label and concluded with an EEEEnnnnddddLLLLeeeevvvveeeellll:::: label set to the
  1114.           values you desire (usually 0.0 in this case).  If this is not done,
  1115.           the initial level defaults to 1.0, and the final release stage will
  1116.  
  1117.  
  1118.  
  1119.                                                                        PPPPaaaaggggeeee 11117777
  1120.  
  1121.  
  1122.  
  1123.  
  1124.  
  1125.  
  1126. ssssyyyynnnntttthhhhpppprrrreeeesssseeeetttt((((4444))))                                                  ssssyyyynnnntttthhhhpppprrrreeeesssseeeetttt((((4444))))
  1127.  
  1128.  
  1129.  
  1130.           be missing.
  1131.  
  1132.      EEEExxxxppppoooonnnneeeennnnttttiiiiaaaallllCCCCuuuurrrrvvvveeeessss::::
  1133.           If "True", envelope will follow an exponential curve between levels.
  1134.           If "False, envelope will follow straight line segments between
  1135.           levels.  Exponential curves are very useful for sounds with extended
  1136.           natural decays, such as pianos and guitars.  ["False"]
  1137.  
  1138.      TTTTrrrriiiiggggggggeeeerrrrMMMMooooddddeeee::::
  1139.           Defined the manner in which the envelope will respond to keydown and
  1140.           keyup events.  Possible values are:
  1141.  
  1142.           """"SSSSiiiinnnngggglllleeeeTTTTrrrriiiiggggggggeeeerrrr""""
  1143.  
  1144.           All voices share one envelope which rstarts only on first key press.
  1145.  
  1146.           """"MMMMuuuullllttttiiiipppplllleeeeTTTTrrrriiiiggggggggeeeerrrr""""
  1147.  
  1148.           Not yet implemented.
  1149.  
  1150.           """"SSSSiiiinnnngggglllleeeeRRRReeeesssseeeetttt""""
  1151.  
  1152.           All voices share one envelope which restarts with each new key
  1153.           press.
  1154.  
  1155.           """"MMMMuuuullllttttiiiipppplllleeeeRRRReeeesssseeeetttt""""
  1156.  
  1157.           Each voice has its own envelope, each one restarts with each new key
  1158.           press.  This is the default.
  1159.  
  1160.      SSSSttttaaaarrrrtttt::::
  1161.  
  1162.      SSSSuuuussssttttaaaaiiiinnnnSSSSttttaaaarrrrtttt::::
  1163.           Index of first segment in the sustain portion of the envelope.  [0]
  1164.  
  1165.      EEEEnnnndddd::::
  1166.  
  1167.      SSSSuuuussssttttaaaaiiiinnnnEEEEnnnndddd::::
  1168.           Index of final segment in the sustain portion of the envelope.  [2]
  1169.  
  1170.      LLLLooooooooppppSSSSttttaaaarrrrtttt::::
  1171.           Index of first segment in the sustain portion of the envelope to be
  1172.           looped.  [0]
  1173.  
  1174.      LLLLooooooooppppEEEEnnnndddd::::
  1175.           Index of final segment in the sustain portion of the envelope to be
  1176.           looped.  [2]
  1177.  
  1178.      LLLLooooooooppppTTTTyyyyppppeeee::::
  1179.           The type of loop to be used.  Possible values are:
  1180.  
  1181.  
  1182.  
  1183.  
  1184.  
  1185.                                                                        PPPPaaaaggggeeee 11118888
  1186.  
  1187.  
  1188.  
  1189.  
  1190.  
  1191.  
  1192. ssssyyyynnnntttthhhhpppprrrreeeesssseeeetttt((((4444))))                                                  ssssyyyynnnntttthhhhpppprrrreeeesssseeeetttt((((4444))))
  1193.  
  1194.  
  1195.  
  1196.           """"OOOOffffffff""""
  1197.  
  1198.           No looping.  This is the default.
  1199.  
  1200.           """"FFFFoooorrrrwwwwaaaarrrrdddd""""
  1201.  
  1202.           Forward-moving loop.
  1203.  
  1204.           """"BBBBaaaacccckkkkwwwwaaaarrrrdddd""""
  1205.  
  1206.           Backwards loop.
  1207.  
  1208.           """"FFFFoooorrrrwwwwaaaarrrrddddAAAAnnnnddddBBBBaaaacccckkkkwwwwaaaarrrrdddd""""
  1209.  
  1210.           Loop runs forward to the final segment, then reverses up to the
  1211.           first segment, then repeats.
  1212.  
  1213.      SSSSuuuussssttttaaaaiiiinnnnLLLLooooooooppppSSSSttttaaaarrrrtttt::::
  1214.           Index of first segment in the envelope's sustain loop.  [0]
  1215.  
  1216.      SSSSuuuussssttttaaaaiiiinnnnLLLLooooooooppppEEEEnnnndddd::::
  1217.           Index of final segment in the envelope's sustain loop.  [2]
  1218.  
  1219.      SSSSuuuussssttttaaaaiiiinnnnLLLLooooooooppppTTTTyyyyppppeeee::::
  1220.           The type of loop for the sustain loop.  See LLLLooooooooppppTTTTyyyyppppeeee::::, above.
  1221.           ["Off"]
  1222.  
  1223.      SSSSuuuussssttttaaaaiiiinnnnLLLLooooooooppppRRRReeeeppppeeeeaaaatttt::::
  1224.           Not yet implemented.
  1225.  
  1226.      RRRReeeelllleeeeaaaasssseeeeSSSSttttaaaarrrrtttt::::
  1227.           Index of first segment in the release portion of the envelope.  [3]
  1228.  
  1229.      RRRReeeelllleeeeaaaasssseeeeEEEEnnnndddd::::
  1230.           Index of final segment in the release portion of the envelope.  [3]
  1231.  
  1232.      RRRReeeelllleeeeaaaasssseeeeLLLLooooooooppppSSSSttttaaaarrrrtttt::::
  1233.           Index of first segment in the envelope's release loop.  [3]
  1234.  
  1235.      RRRReeeelllleeeeaaaasssseeeeLLLLooooooooppppEEEEnnnndddd::::
  1236.           Index of final segment in the envelope's release loop.  [3]
  1237.  
  1238.      RRRReeeelllleeeeaaaasssseeeeLLLLooooooooppppTTTTyyyyppppeeee::::
  1239.           The type of loop for the release loop.  See LLLLooooooooppppTTTTyyyyppppeeee::::, above.
  1240.           ["Off"]
  1241.  
  1242.      RRRReeeelllleeeeaaaasssseeeeLLLLooooooooppppRRRReeeeppppeeeeaaaatttt::::
  1243.           Not yet implemented.
  1244.  
  1245.      GGGGaaaatttteeeeIIIIggggnnnnoooorrrreeee::::
  1246.  
  1247.  
  1248.  
  1249.  
  1250.  
  1251.                                                                        PPPPaaaaggggeeee 11119999
  1252.  
  1253.  
  1254.  
  1255.  
  1256.  
  1257.  
  1258. ssssyyyynnnntttthhhhpppprrrreeeesssseeeetttt((((4444))))                                                  ssssyyyynnnntttthhhhpppprrrreeeesssseeeetttt((((4444))))
  1259.  
  1260.  
  1261.  
  1262.      OOOOnnnneeeeSSSShhhhooootttt::::
  1263.           If set to "True", the envelope will not stop at the end of the
  1264.           sustain portion and will continue on through the release.  This is
  1265.           used for sounds which have no sustain, such as percussion sounds.
  1266.           ["False"]
  1267.  
  1268.      GGGGaaaaiiiinnnn::::
  1269.           The output level multiplier for the envelope.  Each stage's level
  1270.           will be scaled by this value.  This is typically 0 for envelopes
  1271.           whose gain is controlled via GGGGaaaaiiiinnnnCCCCoooonnnnttttrrrroooollllSSSSoooouuuurrrrcccceeees such as
  1272.           NNNNooootttteeeeOOOOnnnnVVVVeeeelllloooocccciiiittttyyyy.  [0.0]
  1273.  
  1274.      GGGGaaaaiiiinnnnddddBBBB::::
  1275.           The output level in decibels for the envelope.  Each stage's level
  1276.           will be scaled by this value.  Same use as GGGGaaaaiiiinnnn::::. [-100]
  1277.  
  1278.      GGGGaaaatttteeeeEEEElllleeeemmmmeeeennnntttt::::
  1279.           If this parameter is true, this envelope will be examined to
  1280.           determine if a given voice should continue to sound, or if the voice
  1281.           should be considered "finished" and shut off.  If false, the state
  1282.           of this envelope will be ignored.  ["True"]
  1283.  
  1284.      GGGGaaaaiiiinnnnCCCCoooonnnnttttrrrroooollllSSSSoooouuuurrrrcccceeee::::
  1285.  
  1286.      GGGGaaaaiiiinnnnMMMMoooodddduuuullllaaaattttiiiioooonnnnSSSSoooouuuurrrrcccceeee::::
  1287.           Source for modulation of the envelope's volume.  See the section on
  1288.           CCCCOOOONNNNTTTTRRRROOOOLLLL SSSSOOOOUUUURRRRCCCCEEEE AAAANNNNDDDD MMMMOOOODDDDUUUULLLLAAAATTTTIIIIOOOONNNN DDDDEEEEPPPPTTTTHHHH PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS for details.
  1289.           ["NoteOnVelocity"]
  1290.  
  1291.      GGGGaaaaiiiinnnnCCCCoooonnnnttttrrrroooollllDDDDeeeepppptttthhhh::::
  1292.  
  1293.      GGGGaaaaiiiinnnnMMMMoooodddduuuullllaaaattttiiiioooonnnnDDDDeeeepppptttthhhh::::
  1294.           The depth of the previous modulation source.  For most modulating
  1295.           sources, the resulting gain will be between 0.0 and
  1296.           GainModulationDepth.  [1.0]
  1297.  
  1298.      AAAAttttttttaaaacccckkkkTTTTiiiimmmmeeeeMMMMoooodddduuuullllaaaattttiiiioooonnnnSSSSoooouuuurrrrcccceeee::::
  1299.  
  1300.      AAAAttttttttaaaacccckkkkTTTTiiiimmmmeeeeCCCCoooonnnnttttrrrroooollllSSSSoooouuuurrrrcccceeee::::
  1301.           Source for modulation of the envelope's attack time.  This must be a
  1302.           _s_t_a_t_i_c source.  See the section on CCCCOOOONNNNTTTTRRRROOOOLLLL SSSSOOOOUUUURRRRCCCCEEEE AAAANNNNDDDD MMMMOOOODDDDUUUULLLLAAAATTTTIIIIOOOONNNN
  1303.           DDDDEEEEPPPPTTTTHHHH PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS for details.  ["None"]
  1304.  
  1305.      AAAAttttttttaaaacccckkkkTTTTiiiimmmmeeeeMMMMoooodddduuuullllaaaattttiiiioooonnnnDDDDeeeepppptttthhhh::::
  1306.  
  1307.      AAAAttttttttaaaacccckkkkTTTTiiiimmmmeeeeCCCCoooonnnnttttrrrroooollllDDDDeeeepppptttthhhh::::
  1308.           The depth of the previous modulation source.  For most modulating
  1309.           sources, the resulting time will be original_time +
  1310.           (AttackTimeControlDepth * n), where 'n' is between 0 and 1.0.  [0.0]
  1311.  
  1312.  
  1313.  
  1314.  
  1315.  
  1316.  
  1317.                                                                        PPPPaaaaggggeeee 22220000
  1318.  
  1319.  
  1320.  
  1321.  
  1322.  
  1323.  
  1324. ssssyyyynnnntttthhhhpppprrrreeeesssseeeetttt((((4444))))                                                  ssssyyyynnnntttthhhhpppprrrreeeesssseeeetttt((((4444))))
  1325.  
  1326.  
  1327.  
  1328.      DDDDeeeeccccaaaayyyyTTTTiiiimmmmeeeeMMMMoooodddduuuullllaaaattttiiiioooonnnnSSSSoooouuuurrrrcccceeee::::
  1329.  
  1330.      DDDDeeeeccccaaaayyyyTTTTiiiimmmmeeeeCCCCoooonnnnttttrrrroooollllSSSSoooouuuurrrrcccceeee::::
  1331.           Source for modulation of the envelope's decay time.  This must be a
  1332.           _s_t_a_t_i_c source.  See the section on CCCCOOOONNNNTTTTRRRROOOOLLLL SSSSOOOOUUUURRRRCCCCEEEE AAAANNNNDDDD MMMMOOOODDDDUUUULLLLAAAATTTTIIIIOOOONNNN
  1333.           DDDDEEEEPPPPTTTTHHHH PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS for details.  ["None"]
  1334.  
  1335.      DDDDeeeeccccaaaayyyyTTTTiiiimmmmeeeeMMMMoooodddduuuullllaaaattttiiiioooonnnnDDDDeeeepppptttthhhh::::
  1336.  
  1337.      DDDDeeeeccccaaaayyyyTTTTiiiimmmmeeeeCCCCoooonnnnttttrrrroooollllDDDDeeeepppptttthhhh::::
  1338.           The depth of the previous modulation source.  For most modulating
  1339.           sources, the resulting time will be original_time +
  1340.           (DecayTimeControlDepth * n), where 'n' is between 0 and 1.0.  [0.0]
  1341.  
  1342. CCCCOOOOMMMMBBBBIIIINNNNAAAATTTTIIIIOOOONNNN PPPPRRRREEEESSSSEEEETTTTSSSS
  1343.      Combination presets are a special class of presets which allow a single
  1344.      MIDI patch to combine up to 128 other presets in a variety of ways.  Each
  1345.      individual preset referenced by a combination must exist as a separate
  1346.      file.  Each of these individual presets may be mapped into a portion of
  1347.      the keyboard range or velocity range in a manner similar to the way
  1348.      individual samples may be mapped into portions of an oscillator's range.
  1349.      Combination parameters are the highest-level parameters available;  they
  1350.      will modify or (in a few cases) override any preset parameter of the same
  1351.      type.
  1352.  
  1353.      Combination presets are extremely powerful.  By allowing any arbitrary
  1354.      keyboard or velocity range to reference an entire preset, each note on
  1355.      the keyboard can be configured to have its own sample with its own unique
  1356.      filters and envelopes.  Combination presets may be nested, i.e.,
  1357.      combination preset A can reference preset B, which itself is a
  1358.      combination, and so forth.  Keyboard ranges may be arbitrarily overlapped
  1359.      and/or layered to allow the creation of large ensemble presets.
  1360.  
  1361.      Each referenced preset is called a ZZZZoooonnnneeee, and the ZZZZoooonnnneeee subsection of the
  1362.      combination is described below, as well as the zone parameters.
  1363.  
  1364. CCCCOOOOMMMMBBBBIIIINNNNAAAATTTTIIIIOOOONNNN HHHHEEEEAAAADDDDEEEERRRR AAAANNNNDDDD PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  1365.      A combination preset begins with the same first two lines as a regular
  1366.      preset (see the top of this man page), but instead of using the GGGGeeeennnneeeerrrraaaallll,
  1367.      OOOOsssscccciiiillllllllaaaattttoooorrrrNNNN, etc., headers, a single header, CCCCoooommmmbbbbiiiinnnnaaaattttiiiioooonnnn, is used,
  1368.      followed by the following parameters:
  1369.  
  1370.      GGGGaaaaiiiinnnn::::
  1371.           The overall volume for this combination preset.  This adjusts the
  1372.           volume of all preset zones.  [1.0]
  1373.  
  1374.      GGGGaaaaiiiinnnnddddBBBB::::
  1375.           The overall gain in decibels for this combination preset.  [0.0]
  1376.  
  1377.      TTTTrrrraaaannnnssssppppoooosssseeee::::
  1378.           The interval in integer semitones to transpose the entire
  1379.           combination.  [0]
  1380.  
  1381.  
  1382.  
  1383.                                                                        PPPPaaaaggggeeee 22221111
  1384.  
  1385.  
  1386.  
  1387.  
  1388.  
  1389.  
  1390. ssssyyyynnnntttthhhhpppprrrreeeesssseeeetttt((((4444))))                                                  ssssyyyynnnntttthhhhpppprrrreeeesssseeeetttt((((4444))))
  1391.  
  1392.  
  1393.  
  1394.      TTTTuuuunnnneeee::::
  1395.           The amount in semitones to adjust the pitch of the combination.
  1396.           [0.0]
  1397.  
  1398.      OOOOuuuuttttBBBBuuuussss::::
  1399.           The output bus assignment for the combination.  See the OOOOuuuuttttBBBBuuuussss::::
  1400.           description in the GGGGeeeennnneeeerrrraaaallll parameters section for details.
  1401.  
  1402. ZZZZOOOONNNNEEEE SSSSUUUUBBBBSSSSEEEECCCCTTTTIIIIOOOONNNN AAAANNNNDDDD PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  1403.      The zone subsection begins with the first ZZZZoooonnnneeee header and ends with the
  1404.      label EEEEnnnnddddZZZZoooonnnneeeessss.  Each preset zone is separated by a ZZZZoooonnnneeee header.  Many of
  1405.      the parameters are identical to those in the Sample subsection of the
  1406.      Oscillator section.  The possible zone parameters are:
  1407.  
  1408.      NNNNaaaammmmeeee::::
  1409.           The full pathname of the preset file for the current zone.  Required
  1410.           for a zone to exist, and no default.
  1411.  
  1412.      GGGGaaaaiiiinnnn::::
  1413.           The overall volume for this preset.  [1.0]
  1414.  
  1415.      GGGGaaaaiiiinnnnddddBBBB::::
  1416.           The overall gain in decibels for this preset.  [0.0]
  1417.  
  1418.      TTTTrrrraaaannnnssssppppoooosssseeee::::
  1419.           The interval in integer semitones to transpose the preset.  [0]
  1420.  
  1421.      TTTTuuuunnnneeee::::
  1422.           The amount in semitones to adjust the pitch of the preset.  [0.0]
  1423.  
  1424.      OOOOuuuuttttBBBBuuuussss::::
  1425.           The output bus assignment for the zone.  See the OOOOuuuuttttBBBBuuuussss::::
  1426.           description in the GGGGeeeennnneeeerrrraaaallll parameters section for details.
  1427.  
  1428.      NNNNooootttteeeeMMMMaaaappppVVVVaaaalllluuuueeeeLLLLoooowwwweeeerrrr::::
  1429.           Specifies the lower limit of the keyboard range in which this preset
  1430.           will sound, as a MIDI key number.  [1]
  1431.  
  1432.      NNNNooootttteeeeMMMMaaaappppVVVVaaaalllluuuueeeeUUUUppppppppeeeerrrr::::
  1433.           Specifies the upper limit of the keyboard range in which this preset
  1434.           will sound, as a MIDI key number.  [127]
  1435.  
  1436.      NNNNooootttteeeeMMMMaaaappppNNNNooootttteeeeLLLLoooowwwweeeerrrr::::
  1437.  
  1438.      NNNNooootttteeeeMMMMaaaappppNNNNoooottttaaaattttiiiioooonnnnLLLLoooowwwweeeerrrr::::
  1439.           Specifies the lower limit of the keyboard range in which this preset
  1440.           will sound, as a note name ["C-1"]
  1441.  
  1442.      NNNNooootttteeeeMMMMaaaappppNNNNooootttteeeeUUUUppppppppeeeerrrr::::
  1443.  
  1444.  
  1445.  
  1446.  
  1447.  
  1448.  
  1449.                                                                        PPPPaaaaggggeeee 22222222
  1450.  
  1451.  
  1452.  
  1453.  
  1454.  
  1455.  
  1456. ssssyyyynnnntttthhhhpppprrrreeeesssseeeetttt((((4444))))                                                  ssssyyyynnnntttthhhhpppprrrreeeesssseeeetttt((((4444))))
  1457.  
  1458.  
  1459.  
  1460.      NNNNooootttteeeeMMMMaaaappppNNNNoooottttaaaattttiiiioooonnnnUUUUppppppppeeeerrrr::::
  1461.           Specifies the upper limit of the keyboard range in which this preset
  1462.           will sound, as a note name.  ["G9"]
  1463.  
  1464.      VVVVeeeelllloooocccciiiittttyyyyMMMMaaaappppLLLLoooowwwweeeerrrr::::
  1465.           Specifies the lower limit of the keyboard velocity range for which
  1466.           this preset will sound.  [1]
  1467.  
  1468.      VVVVeeeelllloooocccciiiittttyyyyMMMMaaaappppUUUUppppppppeeeerrrr::::
  1469.           Specifies the upper limit of the keyboard velocity range for which
  1470.           this preset will sound.  [127]
  1471.  
  1472. PPPPRRRREEEESSSSEEEETTTT FFFFIIIILLLLEEEE NNNNAAAAMMMMIIIINNNNGGGG CCCCOOOONNNNVVVVEEEENNNNTTTTIIIIOOOONNNNSSSS
  1473.      A synthesizer preset file is identified by mmmmiiiiddddiiiissssyyyynnnntttthhhh(1) and by the
  1474.      desktop using the first 8 or so characters in the file, so a preset may
  1475.      be named anything you wish.  However, if you create preset files which
  1476.      you wish to be a part of a General MIDI 128-preset bank directory, all
  1477.      preset files must follow the following naming convention: For presets 1
  1478.      through 128, the first 4 characters of the file's name must be in the
  1479.      form NNNNNNNNNNNN____, where NNNNNNNNNNNN is the General MIDI preset number of the preset
  1480.      expressed as three digits.  For example, preset 4 would begin with
  1481.      "004_", preset 27 would begin with "027_", and preset 112 would begin
  1482.      with "112_".  The remainder of the name may be anything, but it is useful
  1483.      to have it be descriptive of the preset's type.  For now, the percussion
  1484.      preset to be loaded for channel 10 must be named "PercussionMap.preset".
  1485.  
  1486. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  1487.      synthpanel(1), midisynth(1), midikeys(1)
  1488.  
  1489.  
  1490.  
  1491.  
  1492.  
  1493.  
  1494.  
  1495.  
  1496.  
  1497.  
  1498.  
  1499.  
  1500.  
  1501.  
  1502.  
  1503.  
  1504.  
  1505.  
  1506.  
  1507.  
  1508.  
  1509.  
  1510.  
  1511.  
  1512.  
  1513.  
  1514.  
  1515.                                                                        PPPPaaaaggggeeee 22223333
  1516.  
  1517.  
  1518.  
  1519.